1) This is a combined toolset and engine extension for Stencyl 3.

2) The engine extension is found in the "dialog" folder. Move that folder to "[Your Stencyl Workspace]/engine-extensions/dialog".

3) The toolset extension is "DialogExtension.jar". Move that to "[Your Stencyl Workspace]/extensions/DialogExtension.jar".

4) Restart Stencyl if it's already open.

5) In the menu bar, Extensions > Extension Manager to make sure the Dialog Toolset Extension is installed and enabled.

6) Create a new game or open an existing one.

7) In the toolbar, Settings > Extension, make sure the Dialog Engine Extension is installed.

8) Enabled it, then close and reopen your game.

9) Most setting are accessed through Stencyl's dashboard link to the Dialog Extension. What still hasn't been integrated into the editor is object animations (such as the <but> pointer) and custom bitmap fonts. All of the source files can be accessed through "[stencyl workspace]/games/[game folder]/dialog/"

10) To display your dialog in the game, some custom blocks are included:

- show dialog [ ... ]
- show dialog [ ... ] and trigger event [ ... ] upon completion
- show dialog [ ... ] with style [ ... ]
- show dialog [ ... ] with style [ ... ] and trigger event [ ... ] upon completion

- The field after "show dialog" is filled with the name of the Dialog Chunk you wish to display.
- If one of the no-style blocks is used, the default "base" style is shown.
- If a "trigger event" block is used, once the dialog is ended with the <end> tag, the specified Custom Event is called.

In addition, you can set up a Game Attribute to always be TRUE if a Dialog is open, which can be used for game rules such as disallowing player movement during dialog.
The setting for this is in the "Dialog Base" settings in the styles editor, called "controlAttribute". Just set it equal to the name of the Game Attribute you want set to true while Dialog is open.

11) I'd love to hear any feedback, even if it's like "yeah this is okay I might use it in the future whatever. You did an okay job." Was this the most poorly written guide ever? Did you have any trouble getting things set up? If you have hate mail, bug reports, requests, feel free to post at the extensions thread at Stencyl or send me a PM.

12) Thanks.